Linux 系统下构建 Qt

我们假定如下条件：

执行 sudo apt-get install build-essential 即可完成 C/C++ 编译环境的安装。

如果不存在 build-essential 软件包，那么我们需要自行安装 gcc、g++ 编译器等内容。

根据以往经验，我们还应该确保安装以下软件包：

如果不使用 -qt-xcb 编译选项，还应该确保安装以下软件包（通常我们都使用 -qt-xcb 选项）：

其它根据情况推荐安装的模块：

openssl 库的二进制兼容性很差，放到 Qt 上更是如此。

一旦 Qt 没有加载到兼容版本的 openssl 库将会出现 "建立网络连接时卡死"、"程序退出时崩溃" 的情况。

因此我们选择自行构建对应版本的 openssl 库，并在软件发布时自包含 openssl 库。

从 Qt 5.9 Tools and Versions 页面的 Tools & Versions 一节，我们可以了解到官方发布 Qt5.9 时所使用的 openssl 版本为 1.0.2。 因此我们下载 openssl-1.0.2 的源码进行构建。 下载并解压后，进入源码目录下使用如下步骤完成构建：

我们可以从 这里 下载到 Qt 的源码。 下载完成后，使用如下步骤完成构建：

以下是我们选择不构建的 Qt 组件模块，可根据需要自行调整：

如果不需要 QML 相关功能可指定这些：

如果不需要 QtDataVisualization 功能模块可指定：

-skip 可取的值为 Qt 源码目录下的那些顶级目录（如 qtconnectivity）。 请注意，一个顶级目录下可能包含多个 Qt 功能模块。（可通过其 src 子目录下的目录划分看出其所包含的功能模块） 目前暂没有找到好的方法单独 skip Qt 功能模块的构建。

等待 configure 执行完毕，并检查其输出信息没有问题后，我们就可以进行 Qt 的编译和安装了：

如果系统使用的是 Fcitx 输入法，那么 Qt 程序将会出现无法使用输入法的情况，这是因为Qt 本身不支持 Fcitx 输入法，因此我们需要自行构建 fcitx-qt5 插件以为其添加支持。

具体的构建过程可以参阅博主 flfihpv259 的博文： QT5.6.0无法切换fcitx中文输入法问题记录 在此不再赘述，仅多提及几点：

下载 fcitx-qt5 源码时通常选择其最新稳定版的 tag。（对于其它开源软件来说也是如此）

ECM 软件包全称为 Extra CMake Modules，其通常有现成的软件包 extra-cmake-modules 可供安装。

XKBCommon 通常有现成的软件包 libxkbcommon-dev 可供安装。

如果出现找不到 Qt*Config.cmake 文件错误，可在执行 cmake 时指定 CMAKE_PREFIX_PATH 来添加包含路径：

cmake -DCMAKE_PREFIX_PATH=/usr/lib/aarch64-linux-gnu/qt5.9.9/lib/cmake ..

如果系统上已经安装了其它版本的 Qt ，那么有可能找到错误版本的 Qt*Config.cmake 文件，这也可以通过指定 CMAKE_PREFIX_PATH 来解决。

如果出现 Parse error at "IID" 错误，这是由于找不到 Qt 私有头文件导致的，请确保构建 Qt 时应用了 227458 补丁。

可参见对应 Qt 版本的 Qt for X11 Requirements 页面查阅 Qt 对外部库的基本依赖情况。

可通过 Building Qt for Linux/es 页面详细了解 Qt 对外部库的详细依赖情况（只不过有点旧了）。

可参见 Qt Configure Options 页面了解 configure 的使用说明。

如果你是商业版的用户，或许你可以直接使用 Qt Configuration Tool 来构建 Qt。

合并 227458 补丁的方法：

qtbase/mkspecs/features/create_cmake.prf 在不同版本之间可能有差异，但大体上只需要确保删除文件中对于 CMAKE_NO_PRIVATE_INCLUDES 的定义和访问代码即可。

通过 apt list --installed 命令可查看已安装的软件包列表。